home *** CD-ROM | disk | FTP | other *** search
/ Total Network Tools 2002 / NextStepPublishing-TotalNetworkTools2002-Win95.iso / Archive / DNS Lookup / NS-Batch.EXE / README.TXT < prev    next >
Encoding:
Text File  |  2000-05-02  |  6.3 KB  |  184 lines
  1.  
  2. Welcome to NS-Batch.  I wrote this program to help me with the
  3. administration of a web site belonging to a client of mine.
  4. The log file(s) from the web server included the IP addresses
  5. of all machines that accessed the site, but did not include
  6. hostnames corresponding to those addresses.  My client wanted
  7. the hostnames, and I got tired of manually typing (or even
  8. cut'n'pasting) the names from a log file into an NS-Lookup
  9. program.  Thus NS-Batch was born.
  10.  
  11. Both 16-bit (for Windows 3.1) and 32-bit (for Windows '95 and
  12. Windows NT) are available.  Although the 16-bit version will
  13. run under Windows '95, it is not recommended.  The 16-bit 
  14. version is NS-BATCH.EXE.  The 32-bit version is NSB-32.EXE.
  15.  
  16. If you have received NSB32*.ZIP, create an empty directory,
  17. unzip the file into that directory, and then run SETUP.EXE
  18. to install the program.
  19.  
  20. Otherwise, just unzip the file and run the program.
  21.  
  22.  
  23. Interactive Processing - IP Address to Hostname:
  24.  
  25. Enter the IP address for which you want a hostname and press
  26. the upper "Lookup" button (Alt-L).  If a hostname is available,
  27. it will be displayed.
  28.  
  29.  
  30.  
  31. Interactive Processing - Hostname to IP address:
  32.  
  33. Enter the hostname for which you want an IP address and press
  34. the lower "Lookup" button (Alt-O).  If an IP address can be
  35. found, it will be displayed.
  36.  
  37.  
  38.  
  39. Batch Processing:
  40.  
  41. Enter the name of an ASCII text file containing numeric 
  42. IP addresses in dotted-octet notation (i.e., in the form 
  43. 199.102.3.2), and the name of an output file.  Then click 
  44. on  the "Run" button (Alt-U).  The program will read the
  45. input file, searching for IP addresses, and will create an 
  46. output file containing a separate line for each address in 
  47. the input file.  The format of the output file will be 
  48. determined by the options that you select.
  49.  
  50.  
  51. Probing:
  52.  
  53. You can also use NS-Batch to "probe" for the names of all
  54. the machines on a given subnet.  Say for example that you
  55. want the names of all computers whose addresses are in the
  56. range 199.1.11.1 through 199.1.11.254.  Enter the subnet
  57. 199.1.11 (without the trailing '.' character), and the name
  58. of an output file.  Then click on the "Probe" button (Alt-R).
  59. The program will start probing the DNS, searching for IP
  60. addresses that fit the subnet, and will create an output
  61. file containing a separate line for each address in the
  62. input file.  The format of the output file will be determined
  63. by the options that you select.
  64.  
  65. Note that NS-Batch only does DNS lookups, and does not actually
  66. perform a "ping" on each computer reported.
  67.  
  68. Also note that if an address appears in the input file more
  69. than once, the lookup is performed only once.  However, one
  70. of the output fields indicates the number of times each
  71. address appeared in the input.
  72.  
  73. Output Format Options:
  74.  
  75. The output files for both batch processing and probing can
  76. be formatted as desired.  Each line in the output file can
  77. contain up to five fields, separated by the delimiter of
  78. your choice.  The order of the fields can also be adjusted
  79. by selections on the Output Options dialog.
  80.  
  81. * The hexadecimal representation of the binary form of the
  82.   IP address (makes it easy to sort the file).
  83. * The IP address in dotted-octet notation.
  84. * The hostname corresponding to the IP address, if found (for
  85.   example, www.onramp.net).
  86. * The hostname in reverse notation (for example, net.onramp.www).
  87. * A status field describing any anomalies that occurred during
  88.   the lookup.
  89. * A count of how many times each address appeared in the input
  90.   file (applies only to batch operation, not "probing").
  91.  
  92. Also, you may adjust the operation of NS-Batch via the following
  93. selections (on the "Output Options" dialog:
  94.  
  95. * Selecting "Verify that hostnames are valid" will cause
  96.   NS-BATCH to perform a forward lookup of the hostname.
  97.   That is, if NS-BATCH finds that "198.57.35.2" is
  98.   "machine.domain.com", it will then lookup "machine.domain.com"
  99.   to verify that "198.57.35.2" is returned.
  100. * Selecting "Include invalid hostnames in output" (which
  101.   is only applicable if  "Verify that hostnames are valid"
  102.   is checked) will cause NS-BATCH to include in the output
  103.   all hostnames found, even if they fail the forward lookup.
  104. * Selecting "Keep only those found" causes NS-Batch to
  105.   output information about only those IP addresses for
  106.   which the reverse lookup succeeded.
  107.  
  108.  
  109. Comments, Suggestions, etc.
  110.  
  111. Comments are more than welcome, and constructive
  112. suggestions will be incorporated into future versions
  113. of the program.  Please feel free to contact the author
  114. via e-mail at:
  115.  
  116.   jim@jimprice.com, 
  117.  
  118. The latest versions of NS-BATCH and other products can
  119. always be found on the NS-Batch homepage at:
  120.  
  121.   http://www.jimprice.com/jim-soft.htm
  122.  
  123.  
  124. Additional notes about command-line options
  125.  
  126. notes about commandline options
  127.  
  128. The /revbatch /fwdbatch and /probe options
  129. are mutually exclusive
  130.  
  131. The /inifile option (of the form /inifile=filename.ini)
  132. is used to tell NS-Batch to use a different .INI file.
  133. Note that "filename.ini" must contain a ".\" if the
  134. file is in the current working directory.
  135.  
  136. The  /probestartaddr=address and /probeendaddr=address
  137. options are used to indicate the start and end addresses
  138. for a network probe.
  139.  
  140. The /probenetlog=filename.txt option is used
  141. to set the filename for output from a probe
  142. operation.
  143.  
  144. The /fwdbatchinfile=filename.txt option is
  145. used to set the name of the file to be used
  146. for input for a forward (name to address)
  147. batch lookup operation.
  148.  
  149. The /fwdbatchoutfile=filename.txt option is
  150. used to set the name of the file to be used
  151. for output from a forward (name to address)
  152. batch lookup operation.
  153.  
  154.  
  155. The /revbatchinfile=filename.txt option is
  156. used to set the name of the file to be used
  157. for input for a reverse (address to name)
  158. batch lookup operation.
  159.  
  160. The /revbatchoutfile=filename.txt option is
  161. used to set the name of the file to be used
  162. for output from a reverse (address to name)
  163. batch lookup operation.
  164.  
  165.  
  166.  
  167.  
  168.  
  169. Licensing
  170.  
  171. Although ownership of NS-Batch is retained by the author, this 
  172. version may be freely distributed, as long as it is not modified,
  173. and as long as it is accompanied by this notice.  If you really 
  174. like the program, and feel compelled to send money, send a 
  175. small donation to:
  176.  
  177. Jim Price
  178. PMB 406
  179. 13237 Montfort Drive, # 406
  180. Dallas, TX  75240
  181.  
  182.  
  183.  
  184.